home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Internet Tools 1995 April / Internet Tools.iso / fax / leffler / contrib / faxtool / README.faxtool1.3 < prev    next >
Encoding:
Text File  |  1994-11-11  |  9.8 KB  |  319 lines
  1. /*
  2.  * Copyright (c) 1993, 1994 Thomas W. Corson
  3.  * Copyright (c) 1993, 1994 VetMark Systems, Inc. d.b.a Information Dynamics
  4.  *
  5.  * Permission to use, copy, modify, distribute, and sell this software and 
  6.  * its documentation for any purpose is hereby granted without fee, provided
  7.  * that (i) the above copyright notices and this permission notice appear in
  8.  * all copies of the software and related documentation, and (ii) the names of
  9.  * Thomas W. Corson, VetMark Systems, or Information Dynamics may not be used 
  10.  * in any advertising or publicity relating to the software without the 
  11.  * specific, prior written permission of Thomas W. Corson and VetMark Systems.
  12.  * 
  13.  * THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, 
  14.  * EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY 
  15.  * WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.  
  16.  * 
  17.  * IN NO EVENT SHALL THOMAS W. CORSON OR VETMARK SYSTEMS, INC. BE LIABLE FOR
  18.  * ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
  19.  * OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
  20.  * WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF 
  21.  * LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE 
  22.  * OF THIS SOFTWARE.
  23.  */
  24.  
  25. FaxTool - Version 1.3    94/10/28
  26.  
  27. FaxTool is an OpenLook GUI front-end to FlexFax.  The tool is
  28. internationalized to conform to I18N Level 3 (ie, most European
  29. locales).
  30.  
  31. This version supports the following FlexFax commands:
  32.  
  33.     sendfax
  34.     faxstat
  35.     faxrm
  36.     faxalter
  37.     faxinfo
  38.  
  39.  
  40. Capabilities:
  41. ------------
  42.  
  43.     Send
  44.     ----
  45.         Optional Cover Page fill-in.
  46.  
  47.         Fax Phone Number Directory
  48.     
  49.         Document selection via File Chooser or Drag and Drop.
  50.     
  51.         Previewing of Postscript documents via Ghostscript.
  52.     
  53.         Transmission options for Notification, Transmission
  54.         Time, Page Size, and Resolution.
  55.     
  56.     Status
  57.     ------
  58.         Display of Receive or Send Queue.
  59.     
  60.         Rescheduling of pending Send Jobs.
  61.     
  62.         Modification of Notification Flags for pending Send
  63.         Jobs.
  64.     
  65.         Cancellation and deletion of pending Send Jobs.    
  66.  
  67.         Viewing of Received Faxes.
  68.  
  69.         Printing of Received Faxes.
  70.  
  71.  
  72. Differences between FaxTool 1.2 and FaxTool 1.3
  73. -----------------------------------------------
  74.  
  75.     Fixed problem in send notify routine - char array not
  76.     initialized to null.
  77.  
  78.     Increased maximum length of string arrays from 80 to 100.
  79.  
  80.     Added support for gcc compiler and options.
  81.  
  82.     Fixed misc. problems in function do_command.
  83.  
  84.     Ported tool to SVR4.
  85.  
  86.     Fixed problems with status functions when using another machine as the
  87.     fax host.
  88.  
  89.     Fixed problem with "$" not being escaped on coverpage.
  90.  
  91.     Added support for I18N Level 3 Internationalization.
  92.  
  93.     Added faxtool man page.
  94.  
  95.     Added problem and request submission mechanism via GNATS.
  96.  
  97.     Fixed PRs:
  98.  
  99.              330 faxtool  serious   medium
  100.         Can't use status on remote host.
  101.  
  102.              483 faxtool  analyzed  non-criti medium    
  103.         Add gnats to faxtool distribution.
  104.  
  105.             508 faxtool  serious   medium
  106.         Faxtool drops dollar signs in the comments field of the 
  107.         coverpage.
  108.  
  109.              509 faxtool  non-criti medium
  110.         Faxtool ignores Fax Host when querying status.
  111.  
  112.              901 faxtool  non-criti low
  113.         faxtool won't build on SVR4.
  114.  
  115.              907 faxtool  non-criti low 
  116.         faxtool needs a man page
  117.  
  118.              908 faxtool  serious   medium
  119.         Add I18N support to faxtool.
  120.  
  121.              932 faxtool  serious   medium
  122.         query of receive queue takes forever on remote server.
  123.  
  124.              933 faxtool  serious   high
  125.         Company Name does not print on coverpage.
  126.  
  127.  
  128. Differences between FaxTool 1.2 and FaxTool 1.1
  129. -----------------------------------------------
  130.  
  131.     Modified Makefile to add "debug" target.
  132.  
  133.     Added support for FAXSERVER environment variable.  Fax Host
  134.     field on Properties popup now defaults to the value of
  135.     FAXSERVER.  Send button processing now sets the sendfax -h
  136.     option to the value stored in Fax Host.
  137.  
  138.     Fixed bug - Special characters not escaped before calling faxcover.
  139.  
  140.     Fixed bug - Clear button does not reactivate "Add To Directory"
  141.     button.
  142.  
  143.     Fixed bug - "Add To Directory" button does not set textfields
  144.     on directory popup.
  145.  
  146.     Fixed bug - Adding duplicate Fax Directory entry caused core
  147.     dump the next time the scrolling list was selected.
  148.  
  149. Differences between FaxTool 1.1 and FaxTool 1.0
  150. -----------------------------------------------
  151.  
  152.     Added a Fax Directory popup for maintaining and selecting
  153.     Names and Fax Numbers.
  154.  
  155.     Added a Properties popup for specifying Fax Host, Spool
  156.     Directory, and filters for Viewing, Printing, and Previewing faxes.
  157.  
  158.     Added fax id (filename) to Receive Queue display.
  159.  
  160.     Added capability to View, Print and Delete received faxes.
  161.  
  162.     All panels with scrolling lists are now resizeable and the
  163.     scrolling lists expand/contract accordingly.  Similarly,
  164.     FaxTool now lays out properly when invoked using the -scale
  165.     Xview command line option.
  166.  
  167.     It is no longer necessary to have DevGuide installed in order
  168.     to build FaxTool.  The distribution now includes the necessary
  169.     DevGuide include files and libraries, as permitted by the
  170.     DevGuide license agreement (NOTE, however, that these files
  171.     cannot be redistributed except as a part of the complete
  172.     FaxTool source distribution).  The Makefile has been modified
  173.     accordingly to look for the environment variable GUIDEHOME, and
  174.     if it is defined, to build FaxTool using DevGuide.  Otherwise,
  175.     it uses the files in ./include and ./lib.  Note, however, that
  176.     these libraries probably will not work unless you are running
  177.     OpenWindows V3.0.
  178.  
  179. Requirements:
  180. ------------
  181.  
  182.     SunOS 4.1.x or Solaris 2.x
  183.     OpenWindows 3.x
  184.     DevGuide 3.0 (optional)
  185.     An ANSI C Compiler
  186.     FlexFax 2.1 or greater
  187.     Ghostscript (for Previewing)
  188.  
  189.     I have successfully built and run this application on a
  190.     SPARCstation 2 using:
  191.  
  192.         SunOS 4.1.3
  193.         OpenWindows 3.0
  194.         DevGuide 3.0
  195.         SPARCcompiler C or gcc 2.3.3
  196.         FlexFax 2.1 or 2.2
  197.         Ghostscript 2.5.2
  198.  
  199.     I have also successfully built and run this application on a
  200.     SPARCstation 10 using:
  201.  
  202.         Solaris 2.4
  203.         OpenWindows 3.4
  204.         DevGuide 3.0.1
  205.         SPARCcompiler C
  206.         FlexFax 2.1 or 2.2
  207.         Ghostscript 2.5.2
  208.  
  209.  
  210. Installation Notes
  211. ------------------
  212.  
  213. 1) To build faxtool, cd to the directory where you have unpacked the
  214. distribution and modify the Makefile to set BASEDIR to the directory
  215. where you wish the binary, help files, and man pages to be installed.
  216. Then type "make all". Then type "su root" and type "make install".
  217.  
  218. 2) Building the "debug" target makes a version with symbols and which
  219. also logs traces to stderr.
  220.  
  221. 3) /var/spool/fax/bin/faxinfo must have world execute permission:
  222.  
  223.     chmod 755  /var/spool/fax/bin/faxinfo
  224.  
  225. 4) The config file in /var/spool/fax/etc must specify at least 0644 in
  226. order to be able to query the Receive Queue:
  227.  
  228. RecvFileMode:        0644        # recvd facsimiles *are* public
  229.  
  230.  
  231. Internationalization Notes
  232. --------------------------
  233.  
  234. Faxtool is internationalized through I18N Level 3.  This means that it
  235. is possible to localize faxtool for most European languages.  To
  236. produce the necessary localization (L10N) files:
  237.  
  238. 1) Copy the files with extension ".po" from the directory where you
  239. have unpacked the distribution to another working directory.
  240.  
  241. 2) For each line which begins with "msgid", provide the desired
  242. translated text on the line labeled "msgstr".
  243.  
  244. 3) Save the resulting edits.
  245.  
  246. 4) Run msgfmt on the edited files (eg, "msgfmt faxtool_ui_labels.po").
  247. This will produce a file with a ".mo" extension.
  248.  
  249. 5) Move the resulting ".mo" files to the appropriate locale directory
  250. on your system.  This is typically "/usr/openwin/lib/locale/<your local
  251. LANG variable>/LC_MESSAGES". 
  252.  
  253.     Eg, for French, /usr/openwin/lib/locale/fr/LC_MESSAGES
  254.  
  255. 6) You may also edit and translate the file "faxtool.info" to provide
  256. online help text in the local language.
  257.  
  258. 7) If you develop a localized set of files for faxtool, I would
  259. sincerely appreciate receiving copies of the resulting ".po" and
  260. ".info" files.  I will then add them to the distribution, along with
  261. the appropriate acknowledgement, for the benefit of other users.
  262.  
  263.  
  264. Reporting Bugs:
  265. ---------------
  266.  
  267. This distribution includes the ability to report problems, bugs, and
  268. change requests via email using the GNU GNATS send-pr facility.  The
  269. necessary files are installed when you do a "make install".  Please use
  270. this problem reporting system for any and all requests.  To do so, type
  271. "send-pr" and follow the instructions to fill out the form.  More
  272. information can be found in the README in the send-pr subdirectory of
  273. the distribution as well as the man page for "send-pr".
  274.  
  275. Known Bugs:
  276. ----------
  277.  
  278. 1) There is an Xview bug (1071690) in OpenWindows 3.0 which causes the
  279.    "Comments" multiline text field to be obscured when you switch from
  280.    "Status" to "Send" mode.  There are 2 workarounds:
  281.  
  282.     a) Go ahead and enter data into the "Comments" field anyway. It
  283.     will be there even if you can't see it :-).  You can then
  284.     Preview the Cover Page, prior to adding the actual documents to
  285.     send.
  286.  
  287.     b) Run 2 copies of the tool.  One for Send and one for Status.
  288.  
  289.  
  290. If you a) enhance this application, b) successfully port it to other
  291. platforms or environments, or c) fix any bugs, please email the
  292. undersigned and include the system information for your platform along
  293. with any changes which you made to FaxTool.  I will include these in
  294. future releases along with the appropriate acknowledgement.
  295.  
  296. Acknowledgements
  297. ----------------
  298.  
  299. Thanks to following people for bug fixes and/or enhancements:
  300.  
  301. Peter Gross        pag@scg.boulder.co.us
  302. Ian Darwin        ian@sq.com
  303. Wolfgang Schweikert    schweikert@is.danet.de
  304. Camden Clarke        cclarke%astatos.uucp@notable.com
  305.  
  306.  
  307. I hope you find this software useful.
  308.  
  309. ===============================================================================
  310.       Thomas W. Corson          Information Dynamics
  311.       corson@infodyn.COM          3031 Tisch Way
  312.       (Voice) 408-244-9700          Suite 803
  313.       (Fax)   408-244-9724          San Jose, California 95128
  314.  
  315.             WWW: http://www.rahul.net/infodyn/id_home.html
  316.  
  317.          => World Class Products For World Class Companies <=
  318. ===============================================================================
  319.